OpenClaw (Clawdbot) 教程OpenClaw原名 Clawdbot过渡名 Moltbot是 2026 年 1 月突然爆火的开源个人 AI 助手项目由 Peter SteinbergerPSPDFKit 创始人开发。OpenClaw 是一个可执行任务的智能体我们给指令它不仅回答还能主动操作系统、访问网页、处理邮件、整理文件、发起提醒甚至自动编写代码。OpenClaw 是一个把本地算力 大模型 Agent 自动化玩到极致的开发者效率工具。OpenClaw 目标是让 AI 不只是给建议而是直接完成完整工程任务。因为 Anthropic 在 1 月 27 日发律师函称 Clawd / Clawdbot与 Claude 太像项目在当天紧急更名为 Moltbot脱皮龙虾之意吉祥物是小龙虾 Molty 但功能完全一致旧命令 clawdbot 仍然兼容。Moltbot 是项目组为了应对侵权风险想出的过渡名字OpenClaw 这是目前的最终官方名称。OpenClaw 官网: https://openclaw.ai/中文文档 https://docs.openclaw.ai/zh-CNGithub 地址https://github.com/openclaw/openclawOpenClaw 技能合集: https://github.com/VoltAgent/awesome-openclaw-skillsClawbot、Moltbot 和 OpenClaw 其实是同一个开源项目名字演进顺序为Clawdbot → Moltbot → OpenClaw名称时间线背景/原因本质关系Clawdbot / Clawbot2025 年末至 2026 年 1 月初最初项目名灵感来自Claude和claw龙虾爪梗原始名称是最早出现在 GitHub 的身份Moltbot2026 年 1 月 27 日因 Anthropic 商标顾虑被要求更名中间过渡名字功能、代码与 Clawdbot 一致OpenClaw2026 年 1 月 30 日之后抛弃版权冲突、强调开源性/长线品牌当前官方名称也是今后文档、仓库等统一标识安装方法OpenClaw 的安装被设计得极为友好即使是非开发者也能快速上手。系统要求不一定 Mac mini硬件极低2GB RAM 即可运行。环境支持 Mac, Windows, Linux需要安装 Node.js (pnpm) 或使用 Docker。1、推荐安装方式一键脚本直接通过终端执行以下命令。macOS/Linux 系统:curl -fsSL https://openclaw.ai/install.sh | bashWindows 系统#PowerShell iwr -useb https://openclaw.ai/install.ps1 | iex #CMD curl -fsSL https://openclaw.ai/install.cmd -o install.cmd install.cmd del install.cmd这会自动安装 Node.js≥22并完成基本配置。2、手动安装需要Node.js ≥22并完成基本配置使用 npmnpm i -g openclaw # 如果速度慢可以指定国内镜像 npm i -g openclaw --registryhttps://registry.npmmirror.com或使用 pnpmpnpm add -g openclaw安装完成后初始化并安装后台服务launchd / systemd 用户服务openclaw onboard3、从源码安装开发模式git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install pnpm ui:build # 首次运行会自动安装 UI 相关依赖并构建前端界面 pnpm build # 构建整个项目包含后端与相关模块 # 初始化 OpenClaw 并安装为系统后台服务开机自动运行 pnpm openclaw onboard --install-daemon # 开发模式监听 TypeScript 代码变更并自动重载网关服务 pnpm gateway:watch配置说明我们推荐使用一键脚本安装。macOS/Linux 系统:curl -fsSL https://openclaw.ai/install.sh | bashWindows 系统#PowerShell iwr -useb https://openclaw.ai/install.ps1 | iex #CMD curl -fsSL https://openclaw.ai/install.cmd -o install.cmd install.cmd del install.cmd它会完成环境检测并且安装必要的依赖还会启动 onboarding(设置向导) 流程。后期要重新进入设置向导可以执行以下命令openclaw onboard --install-daemon然后会提醒你这个龙虾能力很强当然风险也很大我们选 yesno 就不安装了 就好了接下来我们就选快速启动 QuickStart 选项接下来我们需要配置一个大模型Model/Auth Provider 选择 AI 供应商国内外的供应商基本都支持。如果没有海外的账号配置咱们国内的 Qwen、MiniMax、智谱的 API key 也是可以的认证配置文件OAuth API 密钥在~/.openclaw/agents/agentId/agent/auth-profiles.json后期也可以在这个文件上修改。然后会出现选择聊天工具的选项海外的一般都没有可以选最后一个其他配置比如端口的设置Gateway Port按默认的 18789 即可比如 Skills、包的安装管理器选 npm 或其他可以一路 Yes 下去。选一些自己喜欢的 skills也可以直接跳过使用空格按键选择这些 API key没有的直接选 no最后这三个钩子可以开启使用空格按键选择主要做内容引导日志和会话记录选择Open the Web UI使用浏览器打开安装完后就会自动访问http://127.0.0.1:18789/chat就可以打开聊天界面让它开始工作。比如搜索最新的科技新闻启动后我们可以使用 openclaw status 命令查看状态openclaw status如果你在新手引导期间安装了服务Gateway 网关应该已经在运行openclaw gateway status手动运行前台openclaw gateway --port 18789 --verbose安装后可以执行的命令运行新手引导openclaw onboard --install-daemon快速检查openclaw doctor检查 Gateway 网关健康状态openclaw statusopenclaw health打开仪表板openclaw dashboard卸载使用内置卸载程序openclaw uninstall非交互式自动化 / npxopenclaw uninstall --all --yes --non-interactive npx -y openclaw uninstall --all --yes --non-interactive使用技能技能是包含 SKILL.md 文件的独立文件夹想要为 OpenClaw 代理拓展新功能ClawHub 是查找、安装技能的最优选择。ClawHub 技能仓库地址https://clawhub.ai/ClawHub 国内镜像https://skillhub.tencent.com/安装 ClawHub 工具# 推荐方式npx 无需全局安装 npx clawhublatest --version # 或全局安装方便以后直接用 clawhub 命令 npm install -g clawhub # 或者用 pnpm pnpm add -g clawhub登录clawhub login搜索技能clawhub search postgres backups下载安装新技能clawhub install my-skill-pack批量更新已安装技能clawhub update --all插件管理插件是轻量代码模块可通过新增命令、工具及 Gateway RPC 能力为 OpenClaw 拓展额外功能。查看已加载插件openclaw plugins list安装官方插件示例语音通话插件openclaw plugins install openclaw/voice-call插件安装后重启网关生效openclaw gateway restart常用命令OpenClaw 常用命令一览表分类命令描述初始化与安装openclaw onboard交互式向导配置模型、通道、网关、工作区初始化与安装openclaw setup初始化配置 工作区非交互版初始化与安装openclaw configure交互式配置向导模型、通道、技能网关管理openclaw gateway status查看网关服务状态 RPC 探活网关管理openclaw gateway start启动网关服务网关管理openclaw gateway stop停止网关服务网关管理openclaw gateway restart重启网关服务网关管理openclaw gateway run直接在前台运行网关调试用网关管理openclaw gateway health获取网关健康信息配置管理openclaw config file显示当前配置文件完整路径配置管理openclaw config get path读取配置项配置管理openclaw config set path value修改配置项配置管理openclaw config validate校验配置文件是否合法诊断与状态openclaw doctor一键健康检查 自动修复诊断与状态openclaw status显示会话健康状态和最近联系人诊断与状态openclaw health从运行中的网关拉取健康数据诊断与状态openclaw logs实时查看网关日志其他高频操作openclaw dashboard打开网页控制面板其他高频操作openclaw channels status查看已连接的聊天通道其他高频操作openclaw agent run手动触发一次代理运行改完配置后记得运行openclaw gateway restart让改动生效 通道管理WhatsAppopenclaw channels login或扫描 QRTelegramopenclaw channels add --channel telegram需 Bot TokenDiscordopenclaw channels add --channel discord需 Bot TokeniMessagemacOS 原生桥接Slackopenclaw channels add --channel slack需 Bot Token工作区结构Workspace AnatomyAGENTS.md指令说明USER.md偏好设置MEMORY.md长期记忆HEARTBEAT.md检查清单SOUL.md人格/语气IDENTITY.md名称/主题BOOT.md启动配置根目录~/.openclaw/workspace聊天内斜杠命令/status健康 上下文/context list上下文贡献者/model m切换模型/compact释放窗口空间/new全新会话/stop中止当前运行/tts on|off切换语音/think切换推理模式关键路径映射Essential Path Map主配置~/.openclaw/openclaw.json默认工作区~/.openclaw/workspace/智能体状态目录~/.openclaw/agents/cid/OAuth API 密钥~/.openclaw/agents/agentId/agent/auth-profiles.json如果是旧版本的在~/.openclaw/credentials/向量索引存储~/.openclaw/memory/cid.sqlite全局共享技能~/.openclaw/skills/网关文件日志/tmp/openclaw/*.log语音与 TTS付费OpenAI / ElevenLabs免费Edge TTS无需 API Key自动 TTSmessages.tts.auto: always内存与模型向量搜索memory search X模型切换models set model认证设置models auth setup日志memory/YYYY-MM-DD.mdHooks 与技能ClawHubclawhub install slugHook 列表openclaw hooks list故障排除无 DM 回复 → 配对列表 → 批准群组中静音 → 检查提及模式配置认证过期 →models auth setup-token网关关闭 →doctor --deep内存 Bug → 重建内存索引自动化与研究浏览器browser start/screenshot子代理/subagents list/info定时任务cron list/run cid心跳heartbeat.every: 30m通过第三方云直接安装配置现在各大平台都已经支持这个智能体如果不想安装在本机可以一键部署云上OpenClaw阿里云https://www.aliyun.com/activity/ecs/clawdbot腾讯云https://cloud.tencent.com/developer/article/2624973使用阿里云的轻量级服务器安装https://www.aliyun.com/activity/ecs/clawdbot。可以使用它们的镜像一键安装使用腾讯云的轻量级服务器安装 https://cloud.tencent.com/developer/article/2624973常用命令OpenClaw 常用命令如下命令作用备注 / 参数openclaw status查看 Gateway 当前运行状态包含健康度与上下文信息openclaw health健康检查检测 core、依赖与运行环境openclaw doctor综合诊断与修复建议支持--deep深度检查openclaw onboard交互式初始化向导首次使用推荐openclaw onboard --install-daemon安装系统守护进程后台常驻运行 Gatewayopenclaw onboard --uninstall-daemon卸载守护进程不删除数据openclaw configure交互式配置向导模型、通道、凭据等openclaw config get path获取配置值JSON Pathopenclaw config set path value设置配置项支持 JSON5 / raw 文本openclaw config unset path清除配置项移除单个键值openclaw channels list列出已登录通道WhatsApp / Telegram / Discord 等openclaw channels login登录新的通道账号扫码或授权流程openclaw channels add添加通道Telegram / Discord / Slackopenclaw channels status --probe通道健康检查检测连接可达性openclaw skills list列出技能已安装 / 可用技能openclaw skills info skill技能详情参数、版本信息clawhub install slug从 ClawHub 安装技能官方技能市场openclaw hooks list列出 Hook 列表事件钩子机制openclaw plugins list列出插件查看已安装插件openclaw plugins install id安装插件例如openclaw/voice-callopenclaw plugins enable id启用插件通常需要重启 Gatewayopenclaw models list列出可用模型包含鉴权状态openclaw models status模型状态当前可用性openclaw models auth setup-token模型鉴权配置Cheatsheet 推荐方式openclaw memory search X搜索长期记忆向量搜索openclaw memory index重建记忆索引修复 memory 异常openclaw logs查看日志默认聚合输出openclaw logs --follow实时日志--json / --plain / --limitopenclaw gateway install安装 Gateway 系统服务注册为系统守护进程openclaw gateway start启动 Gateway 服务system service 模式openclaw gateway stop停止 Gateway 服务openclaw gateway restart重启 Gateway 服务配置变更后使用openclaw gateway statusGateway 系统服务状态不同于openclaw statusopenclaw browser start启动浏览器代理Automation 能力openclaw browser screenshot网页截图openclaw subagents list列出子代理openclaw cron list列出定时任务openclaw cron run id执行定时任务openclaw uninstall卸载 Gateway 服务及数据官方推荐openclaw uninstall --all --yes --non-interactive全自动卸载状态 / workspace / 插件openclaw uninstall --state删除状态文件不删除 workspaceopenclaw uninstall --workspace删除工作区agent / workspace 数据openclaw uninstall --service仅卸载系统服务不删除数据openclaw uninstall --dry-run模拟卸载仅展示结果为什么最近这么火真正做到了像JARVIS一样能读写文件、跑终端命令、操作浏览器、收发邮件、日历、写代码、订机票、清空收件箱……本地优先 长期记忆所有对话跨平台共享上下文USER.md 和 memory/ 目录会越用越聪明支持几乎所有大模型Claude、Gemini、OpenAI、Ollama 本地模型、Pi 等社区技能生态爆炸ClawdHub 上已有 500 社区技能Slack、Discord、GitHub、浏览器控制、macOS UI 自动化……安装简单像 npm install实际能力却很 spicy 开发者原话其核心能力包括将自然语言目标拆解为可执行步骤自动调用终端命令创建与修改项目文件运行代码并检测结果根据报错自动修复相比 Claude Code/OpenCode 这种代码补全工具OpenClaw 更接近一个具备执行权限的工程型智能体。Claude Code 与 OpenCode等 强在代码质量与理解OpenClaw 强在自动完成整个工程流程能力维度OpenClawClaude CodeOpenCode任务规划强中中自动执行完整部分部分自我修复有无无工程级操作强强中本地自动化原生支持较弱较弱